<!DOCTYPE HTML>
<html>
<head>
<title>FileSetAttrib | AutoHotkey</title>
<meta name="description" content="The FileSetAttrib command changes the attributes of one or more files or folders. Wildcards are supported." />
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>FileSetAttrib</h1>

<p>改变一个或多个文件或文件夹的属性. 支持通配符.</p>

<pre class="Syntax"><span class="func">FileSetAttrib</span>, Attributes <span class="optional">, FilePattern, OperateOnFolders?, Recurse?</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>Attributes</dt>
  <dd><p>要改变的属性. 例如, <code>+HA-R</code>.</p>
    <p>要方便地打开, 关闭或切换属性, 请分别在以下一个或多个属性字母前加上加号(+), 减号(-) 或脱字符(^):</p>
    <ul>
      <li>R = 只读</li>
      <li>A = 存档</li>
      <li>S = 系统</li>
      <li>H = 隐藏</li>
      <li>N = 普通(仅在单独使用此属性时才有效)</li>
      <li>O = 离线</li>
      <li>T = 临时</li>
    </ul>
    <p class="note"><strong>注意</strong>: 当前, 此命令无法改变文件的压缩状态.</p>
  </dd>

  <dt>FilePattern</dt>
  <dd>单个文件或文件夹的名称或者通配符模式, 例如 <code>C:\Temp\*.tmp</code>. 如果未指定绝对路径, 则假定 <em>FilePattern</em> 在 <a href="../Variables.htm#WorkingDir">%A_WorkingDir%</a>.
    <p>如果省略, 则使用最内层<a href="LoopFile.htm">文件循环</a>的当前文件.</p></dd>

  <dt>OperateOnFolders?</dt>
    <dd><p>如果空白或省略, 则默认为 0(仅对文件进行操作). 否则, 指定下列数字之一:</p>
    <ul>
      <li>0 = 不对文件夹进行操作(仅文件).</li>
      <li>1 = 对匹配通配符模式的所有文件和文件夹进行操作.</li>
      <li>2 = 仅对文件夹进行操作(不操作文件).</li>
    </ul>
      <p class="note"><strong>注意</strong>: 如果 <em>FilePattern</em> 是单个文件夹而不是通配符模式, 那么总是忽略此设置.</p>
      <p>此参数可以为<a href="../Variables.htm#Expressions">表达式</a>.</p></dd>

  <dt>递归?</dt>
  <dd><p>如果空白或省略, 则默认为 0(不对子文件夹进行递归). 否则, 指定下列数字之一:</p>
    <ul>
      <li>0 = 不对子文件夹进行递归.</li>
      <li>1 = 递归子文件夹, 以便对包含在其中的匹配 <em>FilePattern</em> 的所有文件和文件夹进行操作. 将递归所有子文件夹, 而不仅是名称匹配 <em>FilePattern</em> 的那些. 但是, 文件和文件夹的完整路径和名称超过 259 个字符时, 这些文件和文件夹会被跳过, 就像它们不存在一样. 这样的文件很罕见, 因为操作系统一般不允许创建它们.</li>
    </ul>
      <p>此参数可以为<a href="../Variables.htm#Expressions">表达式</a>.</p></dd>

</dl>

<h2 id="Error_Handling">错误处理</h2>
<p><span class="ver">[v1.1.04+]</span>: 此命令失败时会抛出异常. 想了解更多信息, 请参阅<a href="Catch.htm#RuntimeErrors">运行时错误</a>.</p>
<p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被设置为改变属性 <u>失败</u> 的文件数, 否则为 0.</p>
<p>如果找到了文件, 则 <a href="../Variables.htm#LastError">A_LastError</a> 会被设置为 0(零) 或最近一次操作失败时调用操作系统 GetLastError() 函数的结果. 否则 A_LastError 包含了没有找到文件原因的错误码.</p>

<h2 id="Related">相关</h2>
<p><a href="FileGetAttrib.htm">FileGetAttrib</a>, <a href="FileGetTime.htm">FileGetTime</a>, <a href="FileSetTime.htm">FileSetTime</a>, <a href="FileGetSize.htm">FileGetSize</a>, <a href="FileGetVersion.htm">FileGetVersion</a>, <a href="LoopFile.htm">文件循环</a></p>
<h2 id="Examples">示例</h2>
<div class="ex" id="ExTurnOnMultiple">
<p><a class="ex_number" href="#ExTurnOnMultiple"></a> 打开所有文件和目录的 "只读" 和 "隐藏" 属性(子目录不会被递归到).</p>
<pre>FileSetAttrib, +RH, C:\MyFiles\*.*, 1  <em>; +RH 等同于 +R+H</em></pre>
</div>

<div class="ex" id="ExToggle">
<p><a class="ex_number" href="#ExToggle"></a> 切换单个文件夹的 "隐藏" 属性.</p>
<pre>FileSetAttrib, ^H, C:\MyFiles</pre>
</div>

<div class="ex" id="ExMixed">
<p><a class="ex_number" href="#ExMixed"></a> 关闭单个文件的 "只读" 属性并打开 "存档" 属性.</p>
<pre>FileSetAttrib, -R+A, C:\New Text File.txt</pre>
</div>

<div class="ex" id="ExRecurse">
<p><a class="ex_number" href="#ExRecurse"></a> 递归 C 盘上的所有 .ini 文件, 并打开它们的 "存档" 属性.</p>
<pre>FileSetAttrib, +A, C:\*.ini, , 1</pre>
</div>

</body>
</html>